.. highlightlang:: us

.. index:: @f{documentname}

.. _@f{documentname}:

@f{documentname}
================

.. us.tag  @f{documentname} NOTREADYENGLISH fieldfunction

Writes the document file name.

.. function::  @f{documentname}
               @f{documentname(drive.path.name.ext)}

.. us.params

**Parameters**

.. uparam:: drive.path.name.ext

   An optional parameter of the form ``drive.path.name.ext`` can be specified.

.. us.comment

**Comment**

A document name will only displayed if the document has been saved.

.. us.example

**Example**

``@f{documentname}``

``@f{documentname(name.ext)}``

**Output**:

``D:\uniplot\samples\test.ipw``

``test.ipw``

.. seealso::
   :ref:`overview-field-functions`,
   :ref:`editupdate-fields`,
   :ref:`diagraminsert-field-function`

:sub:`id-1504424`